Skip to main content

Token Metadatas

Queries a list of tokens and their metadata, including price, volume, tags, DEX listings, and more. Supports filters like verification, chains, DEXs, and text search.

query Token(
$limit: Int,
$offset: Int,
$verified: Boolean,
$dex: [String!],
$chainUids: [String!],
$showVolume: Boolean,
$search: String
) {
token {
token_metadatas(
limit: $limit,
offset: $offset,
verified: $verified,
dex: $dex,
chain_uids: $chainUids,
show_volume: $showVolume,
search: $search
) {
coinDecimal
displayName
tokenId
description
image
price
price_change_24h
price_change_7d
dex
chain_uids
total_volume
total_volume_24h
tags
min_swap_value
social
is_verified
}
}
}

Example

curl --request POST \
--header 'content-type: application/json' \
--url 'https://testnet.api.euclidprotocol.com/graphql' \
--data '{"query":"query Token($limit: Int, $offset: Int, $verified: Boolean, $dex: [String!], $chainUids: [String!], $showVolume: Boolean, $search: String) {\n token {\n token_metadatas(limit: $limit, offset: $offset, verified: $verified, dex: $dex, chain_uids: $chainUids, show_volume: $showVolume, search: $search) {\n coinDecimal\n displayName\n tokenId\n description\n image\n price\n price_change_24h\n price_change_7d\n dex\n chain_uids\n total_volume\n total_volume_24h\n tags\n min_swap_value\n social\n is_verified\n }\n }\n}","variables":{"limit":5,"offset":null,"verified":null,"dex":"euclid","chainUids":null,"showVolume":null,"search":null}}'

Open in Playground

Arguments

ArgumentTypeDescription
limitIntOptional limit for pagination.
offsetIntOptional offset for pagination.
verifiedBooleanIf true, only return verified tokens.
dex[String!]Filter tokens by DEX identifiers.
chainUids[String!]Filter tokens by the chains they're deployed on.
showVolumeBooleanWhether to include volume-related fields in the result.
searchStringSearch by token name or symbol.

Return Fields

FieldTypeDescription
coinDecimalIntNumber of decimal places for the token.
displayNameStringHuman-readable token name.
tokenIdStringUnique token ID used internally.
descriptionStringToken description.
imageStringImage URL for the token icon.
priceStringCurrent price of the token.
price_change_24hFloatPercentage change in price over the last 24 hours.
price_change_7dFloatPercentage change in price over the last 7 days.
dex[String]List of DEXs where the token is traded.
chain_uids[String]List of chain identifiers the token is available on.
total_volumeFloatTotal trading volume of the token.
total_volume_24hFloat24-hour trading volume of the token.
tags[String]Any associated tags (e.g., "unverified").
min_swap_valueFloatMinimum value required for swapping the token.
socialObjectSocial metadata (e.g., links to Twitter, Discord, etc.).
is_verifiedBooleanIndicates whether the token is verified.